# TapMiniGame 工具使用说明

# 一、资源优化工具(AssetsTools)

# 1. 工具概述

资源优化工具是一个Unity编辑器扩展,用于帮助开发者优化和管理项目资源。主要功能包括:

  • 纹理资源优化
  • 音频资源优化
  • 字体资源分析
  • Prefab引用分析
  • 场景资源引用分析
  • 资源依赖关系查询

# 2. 工具入口

在Unity编辑器菜单栏中选择 TapTap小游戏/Tools/资源优化工具 打开主窗口。

# 3. 功能模块

# 3.1 纹理资源优化(Texture标签页)

用于批量检查和优化项目中的纹理资源。

# 3.1.1 界面布局

# 3.1.2 主要功能

  • 搜索指定目录下的纹理资源
  • 按条件筛选纹理(Read/Write、Mipmap等)
  • 批量修改纹理设置
  • 一键优化选中资源

# 3.2 Prefab引用分析(Prefab标签页)

用于分析Prefab的引用关系。

# 3.2.1 界面布局

# 3.2.2 主要功能

  • 搜索指定目录下的Prefab
  • 查看Prefab引用的资源
  • 查看引用该Prefab的资源
  • 支持直接/间接引用分析

# 3.3 场景资源分析(Scene标签页)

用于分析场景文件的引用关系。

# 3.3.1 界面布局

# 3.3.2 主要功能

  • 搜索指定目录下的场景文件
  • 查看场景引用的资源
  • 查看引用该场景的资源
  • 支持直接/间接引用分析

# 4. 资源引用查询面板

位于工具底部,提供通用的资源引用关系查询功能。

# 4.1 界面说明

# 4.2 功能按钮

  • 查询引用资源(绿色按钮):显示选中资源引用了哪些其他资源
  • 查询被引用(黄色按钮):显示哪些资源引用了选中资源
  • 刷新资源引用(黄色按钮):重新扫描并缓存项目资源引用关系

# 4.3 查询结果说明

  • 直接引用/依赖:资源A直接使用了资源B
  • 间接引用/依赖:资源A通过其他资源间接使用了资源B(显示为深色背景)

# 5. 使用建议

  1. 首次使用引用查询功能时会建立缓存,可能需要一定时间
  2. 项目资源发生较大变动后,建议使用"刷新资源引用"更新缓存
  3. 工具会自动跳过 Assets/Plugins 目录的资源扫描
  4. 建议定期使用工具检查和优化项目资源

# 6. 注意事项

  1. 大型项目首次建立引用缓存可能较慢,请耐心等待
  2. 建议在项目资源整理时使用,避免在打包前进行大规模的资源设置修改
  3. 进行批量修改前建议先备份项目资源

# 7. 常见问题

Q: 为什么某些资源不显示"查询引用资源"按钮? A: 只有复合型资源(如Prefab、Scene等)才会显示该按钮,基础资源(如图片、音频等)只支持查询被引用。


# 二、开发测试工具(DevTools)

# 1. 工具概述

DevTools 是 TapMiniGame SDK 提供的开发测试工具集,用于帮助开发者在开发阶段快速测试和调试小游戏。该工具提供了本地服务器、二维码生成、网络测试等功能。

# 2. 工具入口

在Unity编辑器菜单栏中选择 TapTap小游戏/Tools/Dev Test Tools 打开主窗口。

# 3. 主要功能

# 3.1 游戏信息显示

  • 基本信息
    • App ID
    • 产品名称
    • 公司名称
    • 产品版本
    • 脚本版本
    • 工具版本

# 3.2 本地服务器

  • 服务器选项

    • C# HTTP 内置服务器(无需外部依赖)
    • Node.js 服务器(可选)
  • 服务器功能

    • 自动分配端口(默认8081)
    • 支持端口自定义
    • 显示服务器状态
    • 显示请求数统计

# 3.3 二维码功能

  • 二维码生成

    • 自动生成测试二维码
    • 支持在线二维码生成
    • 一键复制调试URL
  • 调试链接

    • 生成标准格式的小游戏调试链接
    • 支持测试下载链接生成
    • 支持二维码刷新

# 3.4 网络测试

  • 本地访问测试

    • 提供curl命令测试
    • 支持本地文件下载测试
  • 网络连接测试

    • 跨设备连接测试
    • 网络状态检查

# 4. 使用指南

# 4.1 启动本地服务器

  1. 打开Dev Test Tools窗口
  2. 选择服务器类型(推荐使用C# HTTP)
  3. 设置端口号(可选)
  4. 点击"Start Local Server"启动服务器

# 4.2 测试游戏

  1. 确保服务器状态为"Running"
  2. 使用Tap App扫描界面上的二维码

# 4.3 故障排除

如果测试失败,请按以下步骤检查:

  1. 测试curl命令是否正常
  2. 检查Windows防火墙设置
  3. 检查端口是否被占用
  4. 确保设备在同一网络下

# 5. 注意事项

# 5.1 网络要求

  • 确保开发设备和测试设备在同一局域网
  • 防火墙需要允许选定端口的访问
  • 部分功能可能需要互联网连接

# 5.2 性能考虑

  • C# HTTP服务器适用于大多数开发场景
  • 对于特殊需求可以切换到Node.js服务器
  • 建议使用推荐的端口范围

# 5.3 安全建议

  • 仅在开发环境使用此工具
  • 不要在生产环境暴露测试端口

# 6. 常见问题

# Q1: 无法连接到服务器

A: 请检查:

  • 服务器是否正常运行
  • 端口是否被其他程序占用
  • 防火墙设置是否正确
  • 设备是否在同一网络

# Q2: 二维码扫描失败

A: 可以:

  • 点击"Generate Online QR Code"重新生成
  • 使用"Copy URL"获取链接手动输入
  • 确保二维码清晰可见

# Q3: 端口被占用

A: 建议:

  • 使用"Auto"模式自动选择可用端口
  • 手动选择其他推荐端口
  • 检查并关闭占用端口的程序